home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 004 / scht100e.arj / S-CHAT.DOC < prev    next >
Text File  |  1995-05-07  |  43KB  |  1,694 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                   S-Chat v1.00
  32.  
  33.  
  34.                           Full screen online chat door
  35.  
  36.  
  37.                                    User guide
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                   S-Chat v1.00
  67.  
  68.  
  69.                           Full screen online chat door
  70.  
  71.  
  72.                                   May 7, 1995
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.              Software and documentation written by Steven Hendriks
  92.  
  93.                     Copyright (C) 1994,95 by Steven Hendriks
  94.  
  95.                               All rights reserved.
  96.  
  97.  
  98.                     All information in this documentation is
  99.                      subject to change without prior notice
  100.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  101.  
  102.     Table of Contents
  103.  
  104.  
  105.     1  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  106.        1.1  Copyright and License Agreement . . . . . . . . . . . . . . . 4
  107.        1.2  Contacting the author . . . . . . . . . . . . . . . . . . . . 5
  108.        1.3  What is S-Chat  . . . . . . . . . . . . . . . . . . . . . . . 6
  109.        1.4  Included files  . . . . . . . . . . . . . . . . . . . . . . . 6
  110.  
  111.     2  Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  112.        2.1  First time installation . . . . . . . . . . . . . . . . . . . 7
  113.        2.2  Commandline . . . . . . . . . . . . . . . . . . . . . . . . . 7
  114.        2.3  Installation in RemoteAccess  . . . . . . . . . . . . . . . . 8
  115.        2.4  Multi-Language support  . . . . . . . . . . . . . . . . . . . 9
  116.  
  117.     3  The configuration  . . . . . . . . . . . . . . . . . . . . . . .  10
  118.        3.1  System data . . . . . . . . . . . . . . . . . . . . . . . .  10
  119.             Page bell length  . . . . . . . . . . . . . . . . . . . . .  10
  120.             Page reason length  . . . . . . . . . . . . . . . . . . . .  10
  121.             Messagebase . . . . . . . . . . . . . . . . . . . . . . . .  10
  122.                    Area number  . . . . . . . . . . . . . . . . . . . .  10
  123.                    Path . . . . . . . . . . . . . . . . . . . . . . . .  10
  124.             Chat log  . . . . . . . . . . . . . . . . . . . . . . . . .  10
  125.             Log file  . . . . . . . . . . . . . . . . . . . . . . . . .  11
  126.                    Log style  . . . . . . . . . . . . . . . . . . . . .  11
  127.             Send file command . . . . . . . . . . . . . . . . . . . . .  11
  128.             Receive file command  . . . . . . . . . . . . . . . . . . .  11
  129.             Default receive path  . . . . . . . . . . . . . . . . . . .  11
  130.             External Editor . . . . . . . . . . . . . . . . . . . . . .  11
  131.             Multi-node support  . . . . . . . . . . . . . . . . . . . .  12
  132.             Scroll-Lock function  . . . . . . . . . . . . . . . . . . .  12
  133.             Paging Status file  . . . . . . . . . . . . . . . . . . . .  12
  134.              Paging Status ON . . . . . . . . . . . . . . . . . . . . .  12
  135.              Paging Status OFF  . . . . . . . . . . . . . . . . . . . .  12
  136.        3.2  Chat screens  . . . . . . . . . . . . . . . . . . . . . . .  13
  137.        3.3  Paging Times  . . . . . . . . . . . . . . . . . . . . . . .  14
  138.        3.4  Language Editor . . . . . . . . . . . . . . . . . . . . . .  15
  139.             3.4.1  Settings . . . . . . . . . . . . . . . . . . . . . .  16
  140.             3.4.2  Paging . . . . . . . . . . . . . . . . . . . . . . .  16
  141.             3.4.3  Editor . . . . . . . . . . . . . . . . . . . . . . .  17
  142.             3.4.4  Other Strings  . . . . . . . . . . . . . . . . . . .  18
  143.  
  144.     4  Control files  . . . . . . . . . . . . . . . . . . . . . . . . .  19
  145.        4.1  Abbreviations library . . . . . . . . . . . . . . . . . . .  19
  146.        4.2  Hello strings . . . . . . . . . . . . . . . . . . . . . . .  20
  147.        4.3  User control file . . . . . . . . . . . . . . . . . . . . .  21
  148.        4.4  Page songs  . . . . . . . . . . . . . . . . . . . . . . . .  22
  149.  
  150.     5  Control codes  . . . . . . . . . . . . . . . . . . . . . . . . .  23
  151.  
  152.     6  ANSI Screens   . . . . . . . . . . . . . . . . . . . . . . . . .  24
  153.  
  154.     7  Runtime  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  155.  
  156.     8  Registration . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  157.  
  158.     9  Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  159.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  160.  
  161.     1  Introduction
  162.  
  163.  
  164.     1.1  Copyright and License Agreement
  165.  
  166.  
  167.     'S-Chat' refers to all executables and documentation as distributed in
  168.     the compressed file in which the package was released.
  169.  
  170.     Users of S-Chat must accept this disclaimer of warranty:
  171.  
  172.     -    S-Chat is copyrighted material by Steven Hendriks. It may only be
  173.          used in agreement with the conditions set out in this license
  174.          agreement.
  175.  
  176.     -    S-Chat is released as shareware.
  177.  
  178.     -    You may use S-Chat for an evaluation period of one month. After
  179.          this period you MUST either register S-Chat or stop using it.
  180.  
  181.     -    Registration is REQUIRED for commercial usage (in a commercial
  182.          environment, such as business, governmental organization,
  183.          association, school, foundation, or any other form of juridical
  184.          person, or any system where S-Chat is directly or indirectly used
  185.          to make profit).
  186.  
  187.     -    The evaluation version of S-Chat may be distributed freely
  188.          provided no money or any other compensation is asked or accepted
  189.          without prior written permission from the author.
  190.  
  191.     -    S-Chat is supplied as is, without warranty or guarantee of any
  192.          kind, either expressed or implied, as to the fitness for a
  193.          particular purpose or quality or performance of this program,
  194.          except that S-Chat will occupy some disk space.
  195.  
  196.     -    In no event shall Steven Hendriks be liable to you or anyone else
  197.          for any damages or cost, including, but not limited to, any lost
  198.          profits, lost savings or lost income which may result from the use
  199.          or inability to use S-Chat.
  200.  
  201.     -    In no way is Steven Hendriks obligated to you or anyone else to
  202.          provide future versions of, or support for S-Chat.
  203.  
  204.     -    Steven Hendriks reserves the right not to release future shareware
  205.          versions of S-Chat, but switch to a commercial marketing concept
  206.          instead.
  207.  
  208.     -    It is forbidden to modify, adapt, translate, reverse engineer,
  209.          decompile and/or disassemble the software in this package.
  210.          Patching the medium at places that carry the software (including,
  211.          but not limited to, RAM memory and physical media) is seen as a
  212.          program change and is also forbidden.
  213.  
  214.     -    Your use of S-Chat constitutes your agreement to this license and
  215.          disclaimer and your release of the author from any form of
  216.          liability or litigation.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.                                      - 4 -
  223.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  224.  
  225.     1.2  Contacting the author
  226.  
  227.  
  228.     If you have any questions concerning S-Chat, or if you wish to contact
  229.     the author for suggestions etc., you can:
  230.  
  231.     - Call Oasis BBS (24 hours per day, 300 - 28800 bps) :
  232.       +31-1881-3132
  233.  
  234.     - Send a NetMail message to Steven Hendriks at:
  235.       Fidonet         2:2802/140
  236.       VirNet             9:310/1
  237.       SIGnet         27:1331/401
  238.       OASE            200:3110/0
  239.  
  240.     - E-Mail:
  241.       Steven_Hendriks@f140.n2802.z2.fidonet.org
  242.  
  243.     - Send an echomail message in the OASISSOFT support echo.
  244.  
  245.     - Send a letter to this address:
  246.       S. Hendriks
  247.       Hoofd 22
  248.       3214AH Zuidland
  249.       Netherlands
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.                                      - 5 -
  287.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  288.  
  289.     1.3  What is S-Chat
  290.  
  291.  
  292.     S-Chat is the full-screen chat door for bbs-es.
  293.  
  294.  
  295.     Features :
  296.  
  297.     -    Full multi-language support
  298.     -    Split screen horizontal and vertical chat
  299.     -    Fully configurable chat screens
  300.     -    Supports various screen sizes (anything from 23 to 60 lines)
  301.     -    Abbreviation definitions
  302.     -    User control library - Give special users extra privileges, or
  303.          give others less privileges
  304.     -    Fully configurable paging hours, including override features
  305.     -    Sysop DOS shell
  306.     -    File transfer features
  307.     -    File displaying
  308.     -    Guest user support
  309.     -    Supports any DORINFOx.DEF and DOOR.SYS bbs systems
  310.     -    Special RemoteAccess 2.0x support
  311.     -    Supports many messagebases :
  312.          -    Fido (*.MSG)
  313.          -    Hudson (HMB and Multi-HMB)
  314.          -    Squish
  315.          -    Ezycom 1.02
  316.          -    Ezycom 1.10
  317.          -    JAM
  318.     -    Enhanced line editor included
  319.     -    Support for an external full-screen editor
  320.     -    Multi-node support
  321.     -    Supports many popular multi-tasking environments, gives up time-
  322.          slices when idle
  323.  
  324.  
  325.     1.4  Included files
  326.  
  327.  
  328.     This package includes:
  329.  
  330.     S-Chat.EXE     The main program
  331.     S-Chat.OVR     The overlay file which is used by the main program
  332.     SCsetup.EXE    The configuration program
  333.     S-Chat.DOC     This documentation
  334.     S-Chat.ANS     ANSI advertisement screen
  335.     Samples.EXE    Self-extracting archive containing sample
  336.                    configurations, chat screens and page songs.
  337.     Register.EXE   Self-extracting archive containing information about
  338.                    registering S-Chat.
  339.     File_ID.DIZ    Package description
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.                                      - 6 -
  351.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  352.  
  353.     2  Installation
  354.  
  355.  
  356.     2.1  First time installation
  357.  
  358.  
  359.     S-Chat and all files included can be placed either in a separate
  360.     directory, or in the BBS directory. The most common way is creating a
  361.     sub-directory under the BBS directory, and place the files there.
  362.     After placing all files in a directory, start SCsetup.
  363.  
  364.  
  365.     2.2  Commandline
  366.  
  367.  
  368.     These options are available at the commandline:
  369.  
  370.     /N[node]  Specify the node number where S-Chat is currently running on.
  371.  
  372.     /Y        Start up S-Chat in yell mode. The user will be asked for a
  373.               page reason before S-Chat starts yelling the system operator.
  374.               When the user's name is 'Guest', S-Chat will first ask for
  375.               her/his real name.
  376.  
  377.     /M[mode]  Start up S-Chat in a special chat mode. [mode] can be in the
  378.               range 1 through 10, or R for random selection of the chat
  379.               mode. {+}
  380.  
  381.     /LANG[language]     Specify the language to use. [language] can be
  382.                         either the filename (without extension) of the
  383.                         language file to use, or the language title. (For
  384.                         more information, see the chapter about
  385.                         multi-language support).
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.     {+}  In the evaluation version, only one special chat mode is
  411.          available.
  412.  
  413.  
  414.                                      - 7 -
  415.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  416.  
  417.     2.3  Installation in RemoteAccess
  418.  
  419.  
  420.     S-Chat currently supports any DORINFOx.DEF and DOOR.SYS bbs system. It
  421.     also has special support for the RemoteAccess 2.0x EXITINFO.BBS
  422.     dropfile, so it will update the page reason and the wantchat status.
  423.  
  424.     The best way to install S-Chat in RemoteAccess is to place it under an
  425.     alt-functionkey. The reason for this is that RemoteAccess doesn't start
  426.     up the external chat utility when the user online has logged on using
  427.     interactive EMSI.
  428.  
  429.     The command to start S-Chat in chat mode:
  430.          S-CHAT.EXE /MR *! *# *M
  431.     The command to start S-Chat in yell mode:
  432.          S-CHAT.EXE /Y /MR *! *M
  433.  
  434.       *! is used to freeze the timer in RemoteAccess
  435.       *# is used to turn of the wantchat indicator (this isn't necessary
  436.          under RemoteAccess 2.0x while S-Chat will update the wantchat
  437.          indicator in the EXITINFO.BBS dropfile).
  438.       *M is used to incorporate the memory swap function, so that there
  439.          will be more memory available for S-Chat to run in. You could try
  440.          it without memory swap, but when there isn't enough memory
  441.          available for the abbreviations library, you should use the memory
  442.          swap function.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                                      - 8 -
  479.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  480.  
  481.     2.4  Multi-Language support
  482.  
  483.  
  484.     S-Chat has full multi-language support. All language strings can be
  485.     configured with SCsetup.
  486.  
  487.     The language to use can be specified on the S-Chat commandline with
  488.     this commandline option:
  489.  
  490.          /LANG[language]
  491.  
  492.     [language] can be either the filename (without extension) of the
  493.     language file to use, or the language title.
  494.  
  495.     The language can also by specified by placing a file named CHATLANG in
  496.     the current directory, containing only the language filename or the
  497.     language title. (Note: The file 'CHATLANG' has no extension).
  498.     For RemoteAccess users, it can be created by placing the CHATLANG.RAT
  499.     file (included in the S-Chat package) in the main RemoteAccess
  500.     directory, and adding *SCHATLANG to the S-Chat commandline.
  501.  
  502.     When no language is specified, S-Chat will use S-CHAT.SCL. When that
  503.     file is not available, it will use it's internal default strings.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.                                      - 9 -
  543.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  544.  
  545.     3  The configuration
  546.  
  547.  
  548.     3.1  System data
  549.  
  550.  
  551.     The system data is stored in S-Chat.CFG. It can be edited with SCsetup.
  552.  
  553.  
  554.     Page bell length
  555.  
  556.          This is the duration, in seconds, of sysop pages.
  557.  
  558.  
  559.     Page reason length
  560.  
  561.          The minimum length (in characters) of the page reason. When the
  562.          page reason entered by the user is too short, S-Chat will ask the
  563.          page reason again.
  564.  
  565.  
  566.     Messagebase
  567.  
  568.          The messagebase type where messages to the system operator will be
  569.          stored. Available messagebase types are:
  570.          -    Fido (*.MSG)
  571.          -    Hudson (HMB)
  572.          -    Squish
  573.          -    Ezycom 1.02
  574.          -    Ezycom 1.10
  575.          -    JAM
  576.  
  577.          Area number
  578.  
  579.               For the Hudson and Ezycom messagebase, the area number must
  580.               be selected here.
  581.  
  582.          Path
  583.  
  584.               The directory (and filename for Squish/JAM) where the
  585.               messagebase is located.
  586.  
  587.  
  588.     Chat log
  589.  
  590.          The full path and filename of the chat capture file to use. In
  591.          this path\filename, %N will be replaced by the node number S-Chat
  592.          is currently running on.
  593.  
  594.          Example : C:\LOG\CHAT%N.LOG
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.                                      - 10 -
  607.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  608.  
  609.     Log file
  610.  
  611.          The full path and filename of the regular log file to use. In this
  612.          path\filename, %N will be replaced by the node number S-Chat is
  613.          currently running on.
  614.          Generally, the same log file as the bbs log file is used for this.
  615.  
  616.          Example : C:\LOG\BBS%N.LOG
  617.  
  618.  
  619.          Log style
  620.  
  621.               S-Chat can use different log styles:
  622.               -    FrontDoor
  623.               -    SuperBBS
  624.               -    RemoteAccess
  625.               -    Ezycom
  626.  
  627.  
  628.     Send file command
  629.  
  630.          The command that should be executed to send a file to the user
  631.          online.
  632.          %P will be replaced by the comport number, %B by the current bps
  633.          rate, %F by the filename of the file that should be sent.
  634.  
  635.          Example : GSZ.EXE pG0 port %P sz %F
  636.  
  637.  
  638.     Receive file command
  639.  
  640.          The command that should be executed to start receiving files from
  641.          the user online.
  642.          %P will be replaced by the comport number, %B by the current bps
  643.          rate, %F by the directory where received files should be placed.
  644.          In many cases, it is not necessary to specify the directory (%F),
  645.          while S-Chat will first make that directory the current directory,
  646.          and then start the command to receive files.
  647.  
  648.          Example : GSZ.EXE pG0 port %P rz -Z -m
  649.  
  650.  
  651.     Default receive path
  652.  
  653.          This is the default directory where received files will be placed.
  654.  
  655.  
  656.     External Editor
  657.  
  658.          The command that should be executed to start an external
  659.          full-screen editor. This editor will only be used when the user
  660.          online has ANSI emulation enabled. When no editor is configured,
  661.          the internal line editor will be used.
  662.          %P will be replaced by the comport number, %B by the current bps
  663.          rate.
  664.  
  665.          Example : pedit.exe
  666.  
  667.  
  668.  
  669.  
  670.                                      - 11 -
  671.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  672.  
  673.     Multi-node support
  674.  
  675.          S-Chat has some protection built-in for multi-node systems. When
  676.          the multi-node support is enabled, only one node can page the
  677.          system operator at a time. When two or more nodes are paging the
  678.          system operator, only the first one will make sound. This is
  679.          especially useful when running under a multi-tasking environment
  680.          like OS/2.
  681.          When the multi-node support is enabled, and there is no sound at
  682.          all when a user pages the system operator, you should delete the
  683.          file S-Chat.USE from the directory where S-Chat.EXE is located.
  684.  
  685.  
  686.     Scroll-Lock function
  687.  
  688.          The function of the Scroll-Lock key can be configured to these
  689.          settings:
  690.          - Not available :   When Scroll-Lock is active, the system
  691.                              operator is not available.
  692.          - No sound :        When Scroll-Lock is active, paging will be
  693.                              done without sound.
  694.  
  695.  
  696.     Paging Status file
  697.  
  698.          The paging hours can be overriden by using a paging status file.
  699.          When used with RemoteAccess, the filename for this file is
  700.          [RA-directory]\PAGESTAT.RA.
  701.          When the paging status file is not available, or the first
  702.          character in this file is different from both the Paging On and
  703.          Paging Off characters, S-Chat will use the normal paging status
  704.          (paging hours and optionally the Scroll-Lock key status).
  705.  
  706.  
  707.          Paging Status ON
  708.  
  709.               When the Paging Status file is used, this must be configured
  710.               to the first character used in the paging status file to
  711.               override the paging status to ON. When used with
  712.               RemoteAccess, this character is '3'.
  713.  
  714.  
  715.          Paging Status OFF
  716.  
  717.               When the Paging Status file is used, this must be configured
  718.               to the first character used in the paging status file to
  719.               override the paging status to OFF. When used with
  720.               RemoteAccess, this character is '2'.
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.                                      - 12 -
  735.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  736.  
  737.     3.2  Chat screens
  738.  
  739.  
  740.     Besides the two default chat screens, S-Chat can use up to 10
  741.     configurable chat screens {+}.
  742.     The screen background is a normal ANSI screen which can be created with
  743.     any ANSI editor. The filenames for the screen backgrounds are
  744.     S-Chat1.ANS through S-Chat10.ANS. Control codes can be used in these
  745.     chat screens (for a list of control codes, see the paragraph about
  746.     control codes).
  747.  
  748.     S-Chat also needs some information about the screen, like the positions
  749.     of the sysop and user chat windows, the colors to use and where to
  750.     place the time/date display. This is stored in S-Chat1.SCR through
  751.     S-Chat10.SCR, and can be edited with SCsetup.
  752.  
  753.     For each chat window, the position and the size can be changed by using
  754.     the cursor keys. The chat color can also be selected by using the
  755.     cursor keys.
  756.     Multi-colored chat is also available. The colors can be configured for
  757.     some character groups:
  758.     -    Uppercase letters ('A' through 'Z')
  759.     -    Lowercase letters ('a' through 'z')
  760.     -    Numbers ('0' through '9')
  761.     -    Punctuation ('.',':','?',etcetera)
  762.     -    High ASCII (characters 128 through 254)
  763.  
  764.     The default color is used for all characters which are not configured
  765.     separately.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.     {+}  In the evaluation version, only one configurable chat screen can
  795.          be used.
  796.  
  797.  
  798.                                      - 13 -
  799.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  800.  
  801.     3.3  Paging Times
  802.  
  803.  
  804.     The paging times can be configured for each day of the week, in
  805.     quarters of an hour detail.
  806.  
  807.     A bright cyan block means that paging is enabled for that time. A black
  808.     block means paging is disabled.
  809.  
  810.     To edit the paging hours, simply use the cursor keys to walk through
  811.     the hours and days, and use these keys to change the paging status:
  812.  
  813.     Space     Toggle paging status on/off (half hour detail)
  814.     +         Turn paging status on (half hour detail)
  815.     -         Turn paging status off (half hour detail)
  816.     1         Toggle paging status on/off (quarter detail - first quarter)
  817.     2         Toggle paging status on/off (quarter detail - second quarter)
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                      - 14 -
  863.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  864.  
  865.     3.4  Language Editor
  866.  
  867.  
  868.     S-Chat has full multi-language support. All language strings can be
  869.     configured with SCsetup.
  870.  
  871.     In the language editor, the default strings used by S-Chat are
  872.     displayed on the bottom line.
  873.  
  874.     Some control codes are available for all language strings:
  875.  
  876.     [Control+C][FG][BG] Specify the text foreground [FG] and background
  877.                         [BG} colors. When specifying colors, you must
  878.                         always specify BOTH the foreground and background
  879.                         colors!
  880.                         These colors are available:
  881.                         [FG] & [BG] :  0 - Black
  882.                                        1 - Blue
  883.                                        2 - Green
  884.                                        3 - Cyan
  885.                                        4 - Red
  886.                                        5 - Magenta
  887.                                        6 - Brown
  888.                                        7 - Light Gray
  889.                         [FG] only :    8 - Dark Gray
  890.                                        9 - Light Blue
  891.                                        A - Light Green
  892.                                        B - Light Cyan
  893.                                        C - Light Red
  894.                                        D - Light Magenta
  895.                                        E - Yellow
  896.                                        F - White
  897.  
  898.     |                   Will be replaced by a carriage return (CR) and line
  899.                         feed (LF).
  900.  
  901.     @[filename]         Every language string can be replaced with a
  902.                         textfile (.ANS or .ASC). To use this, the first
  903.                         character of the language string must be a '@'
  904.                         (without quotes), followed by the filename (without
  905.                         extension) of the textfile to use.
  906.                         Example : @PAGING
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.                                      - 15 -
  927.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  928.  
  929.     3.4.1  Settings
  930.  
  931.  
  932.     Miscellaneous language settings :
  933.  
  934.  
  935.     Title          The title of this language
  936.  
  937.     Textfile path  The directory where the textfiles (.ANS/.ASC) for this
  938.                    language are located.
  939.  
  940.  
  941.     3.4.2  Paging
  942.  
  943.  
  944.     Strings used for paging the system operator :
  945.  
  946.  
  947.     Before paging       This string is displayed just before the page
  948.                         reason or the guest name is asked.
  949.  
  950.     Guest name          When a 'Guest' user wants to page the system
  951.                         operator, his real name name is asked just before
  952.                         the page reason is asked.
  953.  
  954.     Page reason         This string is displayed when the page reason is
  955.                         asked.
  956.  
  957.     Reason too short    This string is displayed when the entered page
  958.                         reason is too short. (See 'Page reason length').
  959.  
  960.     Paging              This string is displayed when the system operator
  961.                         is being paged.
  962.  
  963.     Not available       This string is displayed when the system operator
  964.                         is not available.
  965.  
  966.     Leave message       The question to ask whether the user wants to leave
  967.                         a message to the system operator or not. (Only
  968.                         displayed when a message area has been configured).
  969.  
  970.     Press Enter         Displayed when the [Enter] key should be displayed
  971.                         to continue. (Only displayed when no message area
  972.                         has been configured).
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.                                      - 16 -
  991.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  992.  
  993.     3.4.3  Editor
  994.  
  995.  
  996.     Strings used when posting a message to the system operator :
  997.  
  998.  
  999.     Start external      Displayed when the external full-screen editor is
  1000.                         started.
  1001.  
  1002.     Start line 1/2/3/4  Displayed when the internal editor is started.
  1003.  
  1004.     Editor menu         Strings/keys used in the editor menu :
  1005.  
  1006.          Editor menu                                  The editor menu as
  1007.                                                       displayed to the
  1008.                                                       user.
  1009.  
  1010.          Continue/Edit/Insert/List/Delete/Save/Abort  The keys to envoke
  1011.                                                       the menu functions.
  1012.  
  1013.     Edit line           Line number question, displayed when the user wants
  1014.                         to edit a line.
  1015.  
  1016.     Insert before line  Line number question, displayed when the user wants
  1017.                         to insert some text.
  1018.  
  1019.     Delete start/end    Line number questions, displayed when the user
  1020.                         wants to delete one or more lines.
  1021.  
  1022.     Invalid line        Displayed when an invalid line number is entered.
  1023.  
  1024.     Abort?              Confirmation question asked when the user chose to
  1025.                         abort the message.
  1026.  
  1027.     Message aborted     Displayed when the message is aborted.
  1028.  
  1029.     Storing message     Displayed when the message is being stored.
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                      - 17 -
  1055.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1056.  
  1057.     3.4.4  Other Strings
  1058.  
  1059.  
  1060.     Other strings used in S-Chat :
  1061.  
  1062.  
  1063.     Chat startup        Displayed when the chat mode is being started.
  1064.  
  1065.     Chat footer         Displayed on the bottom line in the internal
  1066.                         (default) chat screens.
  1067.  
  1068.     Chat end            Displayed when the chat mode has ended.
  1069.  
  1070.     Sysop DOS shell     Displayed when the system operator has shelled to
  1071.                         dos.
  1072.  
  1073.     Sysop back          Displayed when the system operator is back from the
  1074.                         dos shell.
  1075.  
  1076.     Send file           Displayed when the system operator is going to send
  1077.                         one or more files to the user.
  1078.  
  1079.     Receive file        Displayed when the system operator is waiting to
  1080.                         receive one or more files from the user.
  1081.  
  1082.     Show file           Displayed when the system operator is going to show
  1083.                         a file to the user.
  1084.  
  1085.     Yes key             The key to answer a question with YES.
  1086.  
  1087.     No key              The key to answer a question with NO.
  1088.  
  1089.     Time-out warning 1  Displayed when the user has been inactive for some
  1090.                         time.
  1091.  
  1092.     Time-out warning 2  Displayed when the user has been inactive even
  1093.                         longer.
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                      - 18 -
  1119.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1120.  
  1121.     4  Control files
  1122.  
  1123.  
  1124.     Besides the main configuration, S-Chat uses various control files for
  1125.     it's operation. Those are described in this chapter.
  1126.  
  1127.  
  1128.     4.1  Abbreviations library
  1129.  
  1130.  
  1131.     In S-Chat, abbreviations can be used which will then be replaced by
  1132.     another text. S-Chat reads these abbreviations from S-Chat.LIB.
  1133.     The library is currently not configurable with SCsetup, but can be
  1134.     edited with any ASCII editor. The lay-out of S-Chat.LIB is as follows:
  1135.  
  1136.     [original] [replacement] </sysop|/user>
  1137.  
  1138.     [original] is the original text. Only the characters 'A' through 'Z'
  1139.     (and 'a' through 'z') can be used for this. When this text is entered
  1140.     in the chat, S-Chat will replace it with the replacement string. The
  1141.     size for the original string is unlimited <*>.
  1142.  
  1143.     [replacement] can be up to 50 characters long, and can contain any
  1144.     character which can be entered when in the chat.
  1145.  
  1146.     When /SYSOP is used, this abbreviation will only be valid for the
  1147.     system operator. When /USER is used, it will only be valid for the
  1148.     user.
  1149.  
  1150.     There can be as many abbreviations in the library as you like <*>.
  1151.     S-Chat uses a very fast algorithm to process the abbreviations, it will
  1152.     not slow down when hundreds or thousands of abbreviations are used.
  1153.  
  1154.     Examples: PSCAN PalmScan
  1155.               RA RemoteAccess
  1156.               GBYE It was very nice chatting with you, goodbye... /SYSOP
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.     <*>  Unlimited = only limited by the availability of free memory.
  1180.  
  1181.  
  1182.                                      - 19 -
  1183.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1184.  
  1185.     4.2  Hello strings
  1186.  
  1187.  
  1188.     A hello string is the string that is 'typed' as the chat starts up.
  1189.     S-Chat can select a string at random out of an unlimited amount of
  1190.     hello strings. Those strings can be configured in S-Chat.HLO. This file
  1191.     can be edited with any ASCII editor.
  1192.     Control codes can be used in these hello strings (for a list of
  1193.     available control codes, see the paragraph about control codes).
  1194.  
  1195.     Examples: Hello ^S3,
  1196.               Hi ^S3!
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.                                      - 20 -
  1247.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1248.  
  1249.     4.3  User control file
  1250.  
  1251.  
  1252.     In the user control file, you can specify users who get certain
  1253.     privileges, and users who get less privileges.
  1254.  
  1255.     The user control file must be named S-CHAT.USR, and placed in the same
  1256.     directory where S-CHAT.EXE is located.
  1257.  
  1258.     The format of S-CHAT.USR is:
  1259.  
  1260.          [User Name] <options>
  1261.  
  1262.     [User Name]    This is the name of the user for who the privileges
  1263.                    should be altered.
  1264.  
  1265.     <options>      These options are available:
  1266.  
  1267.                    /NotAvail           When the user tries to page the
  1268.                                        system operator, it will never be
  1269.                                        answered (the system operator is not
  1270.                                        available).
  1271.  
  1272.                    /AlwaysPage         Even when trying to page outside the
  1273.                                        paging hours, the system operator
  1274.                                        will be paged. The page bell will
  1275.                                        not sound outside paging hours,
  1276.                                        unless /AlwaysSound is also used.
  1277.  
  1278.                    /NoSound            The page bell will never sound.
  1279.  
  1280.                    /AlwaysSound        The page bell will always sound.
  1281.  
  1282.                    /Song=[filename]    Always use this song when the user
  1283.                                        pages the system operator. The song
  1284.                                        must be placed in the same directory
  1285.                                        where S-CHAT.EXE is located, and
  1286.                                        should have .SNG as file extension.
  1287.                                        {+}
  1288.  
  1289.                    /Screen=[filename]  Always use this chat screen when the
  1290.                                        user pages the system operator. The
  1291.                                        screen files must be placed in the
  1292.                                        same directory where S-CHAT.EXE is
  1293.                                        located, and should have .SCR and
  1294.                                        .ANS as file extensions. {+}
  1295.  
  1296.     Examples :
  1297.  
  1298.     John Doe /NotAvail
  1299.     Jane Doe /NoSound
  1300.     Steven Hendriks /AlwaysPage /AlwaysSound /Song=MYSONG /Screen=MYSCREEN
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.     {+} The /Song and /Screen options are available in the registered
  1307.     version only.
  1308.  
  1309.  
  1310.                                      - 21 -
  1311.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1312.  
  1313.     4.4  Page songs
  1314.  
  1315.  
  1316.     S-Chat uses RemoteAccess-style page songs. It can select a song at
  1317.     random out of up to 99 page songs {+}. The filenames for the songs are
  1318.     S-Chat1.SNG through S-Chat99.SNG. They can be edited using a plain
  1319.     ASCII editor.
  1320.     If you don't want to use random page songs, but just one page song, you
  1321.     should remove all page songs and create S-Chat.SNG, which will then
  1322.     always be used.
  1323.  
  1324.  
  1325.     These are the keywords that can be used in the page songs:
  1326.  
  1327.     TONE [tone] [time]
  1328.     WAIT [time]
  1329.  
  1330.          [tone]    This is the tone in Hz.
  1331.          [time]    The duration of this tone (or silence fore WAIT) in
  1332.                    1/100's seconds.
  1333.  
  1334.     The following table lists several musical octaves and the correct
  1335.     frequency value associated with each note:
  1336.  
  1337.     Note  Oct - 1    2    3    4    5    6
  1338.     ----
  1339.     C       F   45  134 268  536 1071 2145
  1340.     C#      r   71  142 284  568 1136 2273
  1341.     D       e   75  150 301  602 1204 2408
  1342.     D#      q   80  159 319  638 1275 2551
  1343.     E       u   84  169 338  676 1351 2703
  1344.     F       e   90  179 358  716 1432 2864
  1345.     F#      n   95  190 379  758 1517 3034
  1346.     G       c   100 201 402  804 1607 3215
  1347.     G#      y   106 213 426  851 1703 3406
  1348.     A       #   113 225 451  902 1804 3608
  1349.     A#          119 239 478  956 1991 3823
  1350.     B           127 253 506 1012 2025 4050
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.     {+}  In the evaluation version, up to 9 songs can be used.
  1372.  
  1373.  
  1374.                                      - 22 -
  1375.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1376.  
  1377.     5  Control codes
  1378.  
  1379.  
  1380.     In the chat background screens (S-Chat*.ANS), chat hello strings
  1381.     (S-Chat.HLO) and language strings, the following control codes can be
  1382.     used:
  1383.  
  1384.          ^S1  System operator name
  1385.          ^S2  User full name
  1386.          ^S3  User's first name
  1387.          ^SC  The S-Chat copyright notice
  1388.          ^SV  The S-Chat version number
  1389.  
  1390.     ^S means <control>+S
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.                                      - 23 -
  1439.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1440.  
  1441.     6  ANSI Screens 
  1442.  
  1443.  
  1444.     S-Chat supports various screen lengths for all ANSI screens. It will
  1445.     read the user's screen length from DOOR.SYS or from the RemoteAccess
  1446.     2.0x EXITINFO.BBS. When only DORINFOx.DEF is used, the screen length is
  1447.     fixed to 23 lines, while DORINFOx.DEF does not contain the user's
  1448.     screen length.
  1449.  
  1450.     The screen length can never be higher than the screen length on the
  1451.     local system, minus 2 (for the status bar). The maximum screen length
  1452.     is 60 lines.
  1453.  
  1454.     The two internal chat screens use the right screen length
  1455.     automatically. For the fully configurable chat screens, separate
  1456.     screens and settings have to be created.
  1457.  
  1458.     S-Chat will use these files:
  1459.  
  1460.          S-CHATxx.Ayy   ANSI screen
  1461.          S-CHATxx.Syy   Chat screen settings
  1462.  
  1463.     Where xx is the screen number and yy is the screen length.
  1464.  
  1465.     S-Chat will first search for the exact screen length. When not found,
  1466.     it will use the first available lower screen length. When no specific
  1467.     length screens have been found, it will use the default files
  1468.     S-CHATxx.ANS and S-CHATxx.SCR.
  1469.  
  1470.     This procedure is also used for all other ANSI screens which can be
  1471.     used in the configurable multi-language support.
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.                                      - 24 -
  1503.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1504.  
  1505.     7  Runtime
  1506.  
  1507.  
  1508.     During runtime, the following keys are available to the system
  1509.     operator:
  1510.  
  1511.     F1 to F10                Select status line
  1512.     Alt-F1                   Toggle auto-Zmodem receive feature on/off
  1513.     Alt-F10                  Toggle between top/bottom and left/right
  1514.                              standard chat modes, or return to standard
  1515.                              chat mode when in a special chat mode
  1516.     Shift-F1 to Shift-F10    Select special chat modes 1 to 10 {+}
  1517.     Alt-T                    Send (Transfer) a file to the online user
  1518.     Alt-G                    Receive (Get) a file from the online user
  1519.     Alt-V                    View a file
  1520.     Alt-J                    Jump to DOS
  1521.     Alt-H                    Disconnect (Hangup) the online user
  1522.     Escape                   End chat mode
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.     {+}  In the evaluation version, only one special chat mode is
  1563.          available.
  1564.  
  1565.  
  1566.                                      - 25 -
  1567.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1568.  
  1569.     8  Registration
  1570.  
  1571.  
  1572.     After you have evaluated S-Chat for the period of one month, you must
  1573.     either register or discontinue using S-Chat. S-Chat is released as 'try
  1574.     before you buy', so please buy it if you like it.
  1575.  
  1576.     As long as you don't register, S-Chat will remind you that you have not
  1577.     registered when S-Chat is started up.
  1578.  
  1579.     To register, fill out the registration form as included in the
  1580.     REGISTER.EXE archive, and send it to the registration site.
  1581.  
  1582.     For information about prices and registration sites, see the
  1583.     registration forms.
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.                                      - 26 -
  1631.     S-Chat v1.00                                                 User guide    -----------------------------------------------------------------------
  1632.  
  1633.     9  Credits
  1634.  
  1635.  
  1636.     All brand and product names are copyrighted (C) by and/or trademarks
  1637.     (TM) or registered trademarks (R) of their respective holders:
  1638.  
  1639.     Ezycom                        Peter Davies
  1640.     Fido                          Tom Jennings and Fido Software
  1641.     FrontDoor                     Joaquim Homrighausen
  1642.     GSZ                           Omen Technology Inc
  1643.     Hudson messagebase            Adam Hudson
  1644.     RemoteAccess, JAM             Wantree Development and Andrew Milner
  1645.     Pedit                         Logical Decisions
  1646.     SuperBBS                      Aki Antman and Risto Virkkala
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.                                      - 27 -